home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / cmpdirs.lha / CmpDirs / CmpDirs.doc < prev    next >
Text File  |  1995-10-29  |  3KB  |  78 lines
  1.  
  2.  NAME
  3.     CmpDirs - list equal files of two directories
  4.  
  5.  SYNOPSIS
  6.     CmpDirs DIR1/A,DIR2/A,ALL/S,NOXPK/S
  7.  
  8.  FUNCTION
  9.     CmpDirs scans the two specified directories and will list all files of
  10.     the  two  directories which have equal contents. If you have installed
  11.     xpkmaster.library  V2  or  higher  then  files  are compared after xpk
  12.     decompression.
  13.  
  14.  INPUTS
  15.     DIR1/A (required)  - valid  AmigaDOS path specification to a directory.
  16.     DIR2/A (required)  - valid  AmigaDOS path specification to a directory.
  17.                          May be the same as DIR1.
  18.     ALL/S  (optional)  - DIR1  and DIR2 will be scanned recursively if this
  19.                          keyword is specified.
  20.     NOXPK/S (optional) - files  are  not  checked for xpk compression. This
  21.                          speeds  up scanning the directories significantly.
  22.                          If  you  do  not  have installed xpkmaster.library
  23.                          this option is automatically active.
  24.  
  25.  OUTPUTS
  26.     A  list  of  pairs of filenames (with full path). Each two filenames in
  27.     one line refer to files which have exactly the same contents (after xpk
  28.     decompression  if  one  or both of the files are xpk compressed, unless
  29.     NOXPK was specified or you do not have installed xpkmaster.library).
  30.     Files  which  do  not  only have the same contents but _are_ indeed the
  31.     same  file will not be listed. Therefor CmpDirs is still useful if DIR1
  32.     and DIR2 are the same directory or one is a subdirectory of the other.
  33.  
  34.  BUGS
  35.     Not a real bug, but some people might find it anoying: If DIR1 and DIR2
  36.     represent  the same directory or one is a subdirectory of the other and
  37.     there  are  equal files in the (sub)directory then each equal file will
  38.     be  listed  twice  (e. g. if file A and file B are equal you will get a
  39.     message  that file A is equal to file B and another message that file B
  40.     is equal to file A).
  41.     I  will  not  remove  this  behaviour  because  it  may  be  useful for
  42.     automatic processing of the output of CmpDirs.
  43.  
  44.  NOTES
  45.     CmpDirs  may  be  made  resident.  xpkmaster.library (as already stated
  46.     above) needs _not_ to be installed on your system.
  47.  
  48.  DISCLAIMER
  49.     Copyright (c) 1995 by Christian Rattei.
  50.  
  51.     Use CmpDirs at your own risk. I, the author, cannot be made responsible
  52.     for  any  damage  that  is  directly or indirectly caused by the use of
  53.     CmpDirs.
  54.  
  55.     CmpDirs  is  freeware.  It may be copied freely. Please only spread the
  56.     original archive. No files may be added to or removed from the archive,
  57.     neither  may  any files of the archive be modified in any way (the only
  58.     exception  to  this  is  re-packing or re-archiving the whole archive)!
  59.     This archive may be uploaded to Bulletin Board Systems and FTP servers.
  60.     It may also be included in Public-Domain collections.
  61.  
  62.  CREDITS
  63.     CmpDirs  is  based on CompDir by Peter Kunath but was totally rewritten
  64.     from  scratch. CmpDirs does some more checks, has a more detailed error
  65.     handling  and  uses  some less memory which gets quite noticable if you
  66.     scan whole volumes.
  67.  
  68.  HISTORY
  69.     V1.1  (29.10.1995) - first public release.
  70.  
  71.  AUTHOR
  72.     Christian Rattei
  73.     Wankstraße 10
  74.     82362 Weilheim
  75.     Germany
  76.  
  77.     e-mail: rattei@informatik.tu-muenchen.de
  78.